home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / roldx.doc < prev    next >
Text File  |  1995-03-31  |  6KB  |  168 lines
  1.  
  2.                 ROLDX.LIB Copyright 1990 Tom Mullin 
  3.  
  4. Program:  ROLDX.LIB  
  5. Target:   HP48 with serial cable 
  6. Bytes:    3714 
  7. Checksum: #8F69h (when stored as object) 
  8. Version:  1.0 
  9. Date:     9-12-1990 
  10. ----------------------------------------------------------------- 
  11. Features: 
  12.  
  13. - Holds name, address, and phone numbers.  Allows for quick access to 
  14. any one entry.  The entries are sorted on last name as they are entered. 
  15. The program mimics an actual rolodex.  To find a name zero in on the 
  16. first letter of the last name then leaf thru the remaining entries. 
  17.  
  18. - The program is contained in library for reduced clutter. 
  19.  
  20. - Data is kept in user memory.  All Data is kept in just one file.  
  21. Just the data needs to be backed up.  The program will start a new 
  22. data file if one is not present. 
  23.  
  24. - The program can be invoked from anywhere and will pop up current 
  25. entry. 
  26.  
  27. - The program will cleanup after itself restoring: stack, flags, 
  28. directory and menu. 
  29.  
  30. ----------------------------------------------------------------- 
  31. Installation: 
  32.  
  33. - Copy the file roldx.lib to your root directory.   
  34.  
  35. - Recall the file to the stack. 
  36.  
  37. - Type :0:1 STO ENTER to store the library in port 0. 
  38.  
  39. - Purge roldx.lib (it isn't needed anymore) 
  40.  
  41. - Turn the 48 off then on.  The display should blink. 
  42.  
  43. - Type :0:807 ATTACH to attach the library to the home directory. 
  44.  
  45. ----------------------------------------------------------------- 
  46. Program Invocation: 
  47.  
  48. - First use the installation procedure detailed above. 
  49.  
  50. - The program can be run by selecting it from the library menu.  It 
  51. can also be executed by typing ROLDX.  Because the library is 
  52. attached to the home directory it can be accessed anywhere.   
  53.  
  54. - If desired, the program can be attached to a key: 
  55.      Example: 
  56.           Type << ROLDX >> 45.3 ASN to assign the program to 
  57.           the LOG key in user mode.   
  58. ----------------------------------------------------------------- 
  59. Using the Rolodex 
  60.  
  61. - The first time the program is invoked it will create an empty 
  62. database in the current directory.  You should be in the home 
  63. directory the first time you invoke the rolodex.  See the section below 
  64. on placement of files. 
  65.  
  66. - The active menu keys : [EXIT] [ADD] [EDIT] [DEL] [PREV] [NEXT] 
  67.  
  68. - [EXIT]  This will exit the program.  The stack, directory, flags, 
  69. and menu will be restored.   
  70.  
  71. - [ADD]  The user will be prompted to enter the four fields of an 
  72. entry: first name, last name, address (use CR\LF to separate 
  73. multiple lines), and phone number.  The ENTER bar will end each 
  74. entry.  The two name entries enable sorting the phone list  
  75. alphabetically on the last name.  If no first name leave that entry  
  76. blank.    
  77.  
  78.      Example:  Educalc would not have a first name entry 
  79.           and would be sorted under the 'E''s. 
  80.      Example:  Joe Smith would be sorted under the 'S''s. 
  81.  
  82.   All entries wider then two characters will be converted to 
  83. mixed case. 
  84.  
  85. - EDIT: The current entry will be edited.  The user will be 
  86. prompted for the field to edit.  The ENTER bar will end an entry. 
  87.  
  88. - DEL: The user will be prompted to delete the current entry. 
  89.  
  90. - PREV: The previous entry will displayed. 
  91.  
  92. - NEXT: The next entry will be displayed.     
  93. ----------------------------------------------------------------- 
  94. Speed Searching Keys: 
  95.  
  96. - The A-Z keys can be used to quickly go to any entry.  
  97.  
  98. - [G - Z,' ']  Push the key and the first entry that starts with 
  99. that letter will be displayed.   
  100.  
  101.      Example:  The number of Joe Smith is desired.  Push 'S'.  The 
  102. First 'S' entry will be displayed.  Push the 'S' key repeatedly to 
  103. view all the 'S' entries.   
  104.  
  105.      If an entry's last name doesn't start with a letter A-Z then 
  106. it will be stored at the end of the database.  The space key will 
  107. go right to these entries.  Repeatedly pressing this key will view 
  108. all these non alphabetical entries. 
  109.  
  110. - [alpha A-F]  Because of the menu keys the alpha shift key will 
  111. have to be pressed first to speed search the letters 'A' - 'F'.  
  112.  
  113.      Example : The number of Educalc is to be displayed.  Push the 
  114. alpha shift key then 'E'.  The first 'E' entry will then become the 
  115. current entry. 
  116.  
  117. ----------------------------------------------------------------- 
  118. Placement of Files: 
  119.  
  120.      The program resides in a library.  The data is contained in a 
  121. list ('Roldata') that resides in the current directory or the home 
  122. directory.  If Roldata is in neither of these two locations the 
  123. file Roldata will be created in the current directory. 
  124.  
  125.      ROLDX should be invoked for the first time from the home directory.   
  126. This will place the data file in the home directory making it  
  127. accessible from anywhere. 
  128.  
  129.      The user can also have multiple phone lists by creating multiple  
  130. Roldatas in different subdirectories.   
  131.  
  132. ------------------------------------------------------------------- 
  133.  
  134. Thanks to Eric L. Hernes I. for the original HP28 rolodex program 
  135. (ITEM #14 comp.sys.handhelds) 
  136.  
  137. Also thanks to HP BBS for the USRLIB program. 
  138.  
  139. Future release:  
  140.  
  141. - Speed Search on more then just the first entry. 
  142.  
  143. - String packing would decrease the 'Roldata' size. 
  144.  
  145. - I wish there was an OBGET function on the HP48.  It would 
  146. streamline ROLDX.  Maybe an assembly language routine would get a 
  147. string from a list of lists of strings. 
  148.  
  149. - Allow user to modify number and name of fields to allow for 
  150. different databases to be serviced by the same library. 
  151.  
  152. - Have data sorted by separate B-Tree index.  User could sort data 
  153. on say phone number, city, etc on the fly.  
  154.  
  155. - Add [DIAL] key if it ever becomes possible to use the HP48 as a 
  156. phone dialer 
  157.  
  158. ROLDX Copyright 1990 Tom Mullin   
  159. This library can be freely distributed under the following conditions: 
  160. 1) This file must be included with the program if possible. 
  161. 2) You may not charge money for this library.  
  162.  
  163. Comments: Tom Mullin,  
  164.           2412 Palm Ave. 
  165.           Manhattan Beach, CA 90266 
  166.           213-545-9888 evenings 
  167.           or tmullin on HP BBS 
  168.